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Package com.xis.types 

This package contains classes that provide several standard TypeMetaData classes for describing types and their 
constraints, and for rendering and editing values of those types. 



See: 



Dexcripttgn 



Interface Summary 


Data Test 


The DataTest interface snecifies methods for Object validation 


HTMLTypxin 


This interface defines the 10 for HTML. 


SMWJnary Function 


The Suiwtiary Function interface defines generic summary ftincrionality based upon provided 

UipUi> Uula Values. 




The SwingTypelO interface allows for the use of both swing editors, allowing swing 
a swing environment. 


Zex(I}:pelO 


The TextTypelo interface provides a means of formatting objects in a textual fashion, as well 
as parsing text from which an object is created. 


Tvped Value 


The TypedValue interface is used to hold an object that carries its own TypeMetaData with 
it. 


TvpeEdhor 


The TypeEditor interface defines methods for editing attributes provided by the types 

implemented within this package. 




The Type 10 interface provides a common base from which other Type IDs can extend, such as 
HTMLTypelO, SwingTypelO, etc. 


TypeAfefafiaja 


The TypeMetaData interface defines generic type accessors for object comparing^ editing, 
formatting, rendering, and validation. 


TypeMetaData Factory 


The TypeMfetaDataFactory interface defines a class that can create TypeMetaData for a 
given Class Type. 




The TypeRenderer interface defines methods for rendering attributes provided by the types 
implemented within this package. 


ValidTesiProxv 


The ValidTestProxy interface 


WMLTvpeEditor 


The WMLTypeEdi tor interface defines methods for rendering attributes provided by the types 
implemented within this package. 


WMLTvpelO 


This interface defines the 10 for WML format. 


WML TypeRendersr 


The WMLTypeRenderer interface defines methods for rendering attributes provided by the 
types implemented within this package. 


muypMQ 


The XMLTypelO interface provides a means of formatting objects in a XML textual fashion, as 
well as parsing XML text for creating an object. 



• 



Class Summary 


AbstractPataTest 


The AbstractDataTest class provides a default implementation of test 
(Object) 


AbstracjiT^peiyietaData 


AbstractTypeMetaData provides a partial implementation of 
TypeMetaDaca to relieve the XIS developer from explicitly implementing 
irrelevant mediods. 


4rea 13 fUii ce rta i njy Ty pcM eta Da ta 


AreaOfUncertaintyTypeMecaData is a type object that supports 
AreaOfUncertaincy objects. 


ArrayListTvpeMetaDafa 


ArrayListTypeMetaDa ta is a type abject that supports 

jcr^a.util. Array List objects. 


ArrayTypeMetaData 


ArrayTypeMetaData is a type object that supports Java.lang.re/Iect.Array 
objects. 




BeanTypeMetaData is a type object that supports j ova. beans objects. 


Boo ieanTypelM eta Data 


The BooleanTypeMetaOata is a type object that supports Boolean objects. 


BooJea nTvpeM etaDa ta Facto ry 


A BooleanTypeMetaOataFactory can create a 
BooleanTypeMetaData forgiven booleans. 


CachedTvpeMetaData 


CachedTypeMetaDat:a is a type object that simply delegates all 
TypeMetaData calls to another TypeMetaData. 


Qa§.sj jlca tjo iiTy peM eta D a ta 


Classif icationTypeMetaData Is a type object that supports 

Classification objects. 


Co llectionsTv neM eta Da ta 


ColiectionsTypeMetaData is a type object that supports Collection 
objects. 


ColorTvpelWetaData 


The ColorTypeMetaData class Implements TypeMetaData for Color 
objects. 


Colo rXy peMeja Data Factory 


A ColorTypeMetiaDataf actory can create a ColorTypeMetaData for 
a given Color object. 


ConyersionNumericTy peMetaPata 


A generic NumericTypeMetaData for converting from one unit to another. 




CurrencyTypeMetaData is a type object that supports Number objects 
that represent Currency values. 


PateTimeTypelVIetaPata 


DateTimeTypeMetaData is a type object that supports Date objects. 


DaleTimeTypeiVletaPataFacipry 


A Da CeTimeTypeMet a Data Factory can create a 
DateTimeTypeMetaData for given Date objects. 


PiscreteRangeStringTypeMetaData 


DiscreteRangeStringTypeMetaData is a type object that supports 


DispiavLabelTvpeMetaData 


DisplayLabelTypeMetaData is a type object that supports supports 
DisplayLabel objects. 


PTGTvpeMetaData 


DTGTypeMetaData is a type object that supports Date objects. 


EnumerationType 


Class to implement an enumeration in Java. 


EnumeratlonTypeMetaData 


The EnumerationTypeMetaData class is used to represent integer 
constants as strings to the user. 


FontTvpeMetaData 


FontTypeMetaData is a type object that supports Font objects. 


HasUMapTvneiMetaData 


HashMapTypeMetaData is a type object that supports JavcuttLHashMap 
objects. 



9 



H ash Se tT Y peMeta Da ta 


HashSetTypeMetaData is a type object that supports java.uuLMashSet 
objects. 




IconShapeTypeMetaDsza is a type object that supports IconShape 
objects. 


IconTypefVl etajja t_a 


iconTypeMetaData is a tynpz object that supports Icon objects. 


.jinked Lis tTypeiyi eta Da.ta 


i^xnjcsQi^isc i ypene caua ua id a type uujCv«v Luai suppons 
javaMuLLinkedList objects. 


UstTypeiVlelaData 


ListTypeMetaOata is a type object that supports jaycuULList objects. 


M 0 u sejVta p.Prj&xx 


The MouseMapProxy class allows TypeEditors access to the map without 
requiring them to having any cornpile time knowledge of the map's 
existence. 


(N.U m be r C o m PACa tor 


An implementation of the Comparator interface that compares two objects 
that extend Number, or that both implement Comparable, with the class of 
one assignable from the other. 


N u m e r i cT Y pe M et a D a ta 


NumericTypeMetaData* is a type object that supports A/um^er objects 


NumericTvpeMetaDataFactory 


A NumericTypeMetaDataFactory can create NumericTypeMetaData 
for a given class type or method return type. 


yJU ^i*. j.PSiXieia.ua la 


Ob^ ectTypeMetaData is a type that supports a simple Object and is 
proviQcQ lo 4UiCNiy aua aruiuary aiLrtuuie lypcs lo a waLa oource inierrace 
without writing a more specific type handler. 


PercentTvpeMetaData 


PercentTypeMetaData is a type object that supports Number objects that 
represent PercentC^o) values. 


ProbabilitYTvpeMetaData 


ProbabilityTypeMetaData is a type object that supports Number 
objects that represent Probability values. 


Ren amedTy peM etaDa ta 


RenamedTypeMetaOata simply delegates all TypeMetaData calls to 
another TypeMetaData except for the getNameQ, which is overridden with 
the given value. 


ResjzedTex tTy peMetaDa ta 


ResizedTextTypeMetaData simply delegates all TypeMetaData calls to 
another TypeMetaData except for the getPixeliVidthQ ^ which is overridden 
with the given value. 


Resources 


The Resources class is automatically generated and must be public, but it 
is intended to be used only by Java's internationalization support classes. 


S martDu raiipjiTypeM eta Data 


A SmartDurationTypeMetaData for converting from one time unit to 
another based on the magnitude of the duration value. 


Sj jdngTy pejyi etaPata 


StringTypeMetaData is a type object that supports String objects. 


St ri ngTy iieM eta D a ta Fa c to ry 


A StringTypeMetaDataFactory can create a StringTypeMetaData 
for a given String object. 


TextTy peiVletaData 


TextTypeMetaData is a type object that supports Text objects. 


lypedValueTypeMetajData 


TypedVaiueTypeMetaOata is a type object that supports supports 
TypedValue objects. 


IXpeE; d it or Bean Co n tex tChj LdS u ppo rt 


The TypeEditorBeanContextChildSupport class handles most of the 
responsibilities of a TypeEditor and a BeanContextChild. 


TYDeEditorSupport 


The TypeEditcrSupport class handles most of the responsibilities of a 
TypeEditor. 


TvpelOPluggableService 


The Type lOP Luggable Service class is responsible for loading TypelOs. 


TvoelORegistry 


The TypeiORegiatry class is a registry for different implementations of 
TypelO classes. 



TvpelOSupport 


The TypeI03upport provides support for TypeMetaData's getTypelO 

methods. 


IXPe^MetaDataJDelega tor 


TypeMetdDataDelegator is a type object that simply delegates all 
TypeMetsiData cslls to another TypeMetaData. 


IypeMetaPataFaj:lQryPluggableS.eryk 


The TypeMetaDatardctoryPLuggablaService class is responsible for 


TvneMetaDataFactorySfcore 


This Class stores TypeMetaDataFactories. 


TypePreferences 


This class is used by TypeMetaData instances to pass information about 
preferred TypeMetaData objects. 




The Types class is a holder class for the RESOURCES global variable for 
resource properties of the com.xis.types package. 


UBLTyaeM eta D aj a 


URLTypeMetaData is a type object that supports URL objects. 



Exception Summary 


NoSuch Enumeration Exception 


Class to implement an enumeration exceptioa in Java. 


ParseFatledException 


A PacseFaiLedEjcception is thrown (typically by TypelO objects) when it is not 
possible to parse a given String as desired. 


TestFailedException 


The TestrailedException is thrown from the "testQ" method of a DataTest 
subclass when the value fails the test. 



Package com.xis.types Description 

This package contains classes that provide several standard TypeMetaData classes for describing types and their 
constrain ts» and for rendering and editing values of those types. 
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HelloWorldjava 

/* XIS Tutorial standalone sequence example 1 data class. */ 

public class HelloWorld { 
private float value = 1 .5f; 

public String toString() { 
return "Hello World!"; 

} 

public int getlD() { 
return 5; 

} 

public float getValueO { 
return value; 

} 

// uncomment this to make "value" editable 
/* 

public void setValue(float value) { 
this.value = value; 

} 
*/ 

} 
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Figure 16A 

TestHarness.java 

/* XIS Tutorial standalone sequence example 1 XIS interfacing. */ 
import javax.swing.JFrame; 
import java.awt.event.WinclowAdapter; 
import java.awt.event.WindowEvent; 
import com.xis.propertysheet.PropertySheetlnfoBean; 
import com.xis.ui.UIBeanEvent; )■ 
import com.xis.ui.UIBeanAdapter; 
import com.xis.leif.im.BaselnfoModel; 

public class TestHarness { 

public static void main(StringQ args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager(false); 

// a property sheet infobean to display HelloWorld's attributes 
PropertySheetlnfoBean properties = new PropertySheetlnfoBean(); 
propertles.addRawDataltem(new HelloWorid()); 



J 



1604 



> 1606 



// add listener for 'OK,' 'cancel,' or close, which generate 'close' events 
properties.addUIBeanListener( 
new UIBeanAdapterO { 
public void closed(UIBeanEvent event) { ■ > 1608 

System.exit(O); 

} 



} 

): 

// a top-level frame to hold our property sheet infobean 
JFrame frame = new JFrame("HelloWorld Properties"); 
// add a listener for window closing 

frame.addWindowListener( V i6iOA 

new WindowAdapterO { 

public void windowClosing(WindowEvent e) { 

System.exit(O); ^ 

} 



J 



): 



} 



Figure 16B 



Continuation of TestHarness.java 



// stick the bean in the frame and display it 

frame.getContentPane().add(properties); 
frame.pacl<{); 

frame.setVisible(true); 
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Figure 18A 



HeiloWorldjava 

/* XIS Tutorial standalone sequence example 2 data class. 7 
/*{7 

import java.awt. Color; 

import java.beans.PropertyChangeSupport; 

import java.beans.PropertyChangeListener; 

/*}7 

public class HelloWorld { 

/*{7 

private int value = 1 ; 

private Color myColor = Color.green; 



r 



II this member class helps distribute property change events within XIS 
private PropertyChangeSupport propertyChangeSupport = 

new PropertyChangeSupport(this); 

// two aux methods to let other XIS objects pay attention to this one 
public void addPropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupport.addPropertyChangeUstener(l); 

public void removePropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupport.removePropertyChangeListener(l); 



public String toString() { 

return "A HelloWorld Object"; 

} 

public String getGreeting() { 
return "Hello World!"; 

} 

*}7 

public int getlD(){ 
return 5; 

} 



Figure 18B 

Continuation of of HelloWorld.iava 



public /*{*/ int /*}*/ getValueQ { 
return value; 

} 

/*{*/ 

public void setValue(int value) { 
// only update and fire property change if this is really a change 
if (this.value 1= value) { 
I int oldValue = this.value; 

J this.value = value; 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePropertyChange("value", oldValue, value); 

} 

public Color getMyColor() { 
return myColor; 

} 

public void setMyColor(Color myColor) { 
// only update and fire property change if this is really a change 
if (this. myColor != myColor) { 
Color oldMyColor = this.myColor; 
this.myColor = myColor; 

// fire property change event to notify other XIS objects ~) , 
propertyChangeSupport.firePropertyChange("myColor", > \2>0t 

OldMyColor, myColor); J 

} 

. /*}*/ 



} 
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TestHarness-java 

/* XIS Tutorial standalone sequence step 2 XIS interfadng. */ 

import javax.swingJFrame; 

import java.awt.event.WindowAdapter; 

import java.awt.eventWindowEvent; 

import com.xis.propertyslieet.PropertySheetlnfoBean; 

import com.xis.ui.UIBeanEvent; 

import com.xis.ui.UlBeanAdapter; 

import com.xis.ieif.im.BaselnfoModel; 

/*{*/ 

import jclass.chart JCChart; 

import com.xis.pIotPlotlnfoBean; 

import com.xis.plotchartviews.LeifChartView; 

/*}7 

public class TestHarness { 

public static void main(StringQ args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager{false); 

HelloWorld hello = new HelloWorld(); 

// a property sheet infobean to display HelloWorld's attributes 
PropertySheetlnfoBean properties = new PropertySheetlnfoBean{); 
properties.addRawDataltem(hello); 

// add a listener for 'OK' or 'cancel', which generate 'close' events 
properties. addUIBeanListener( - 
new UIBeanAdapterO { 

public void cIosed(UIBeanEvent event) { 
System.exit(O); 

} 

} 

): 



Figure 19B 

Continuation of TestHarriessJava 



// a top-level frame to hold our property sheet infobean 
JFrame propertySheetFrame = new JFramefHelloWorld Properties"); 
// add a listener for window closing 
propertySheetFrame. addWindowListener( 
new WindowAdapterO { 
public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 

// stick the property Sheet bean in the frame and display it 
propertySheetFrame.getContentPane().add(properties); 
propertySheetFrame. pack(); 
propertySheetFrame.setVisible(tnje); 

// now we create a plot infobean to plot HelloWorld's numeric attribute 
5 PlotlnfoBean plot = new PlotlnfoBean(); 
plot.addRawDataltems(new ObjectQ { hello }); 
plot.setChartType(JCChart.BAR); 

//the altematives are SCATTER^PLOT. PLOT, AREA. PIE, CANDLE, 
// and STACKING_BAR, though not all will make sense in this example 

// a top-level frame as before to hold our property sheet infobean 
JFrame plotFrame = new JFrame("HelloWorld Plot"); 

// stick the plot bean in and put it up 
plotFrame.getContentPane().add(plot); 
plotFrame,pack(); 
plotFrame.setVisible(true); 



} 

} 
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HelloWorldJava 

/* XIS Tutorial standalone sequence step 3 data class. */ 
import java.awt. Color; 

// (property change support moved to HelloWorldTranslator) 

public class HelloWorld { 
private int value = 1 ; 
private Color myColor = Color.green; 

public String toStringO { 

return "A HelloWorid Object"; 

} 

public String getGreetingO { 
return "Hello Worid!"; 

} 

public int getID(){ 
return 5; 

} 

public int getValue{) { 
return value; 

} 

/*{*/ 

public void setValue(int value) { 
. // all the worrying about change events is moved to the translator, 
// so we just need to do the bare change operation (unless nonXl6 
// components need to listen to PropertyChanges) 
this.value = value; 

} 

/*}*/ 

public Color getMyColor() { 
return myColor; 

} 

/*{7 

public void setMyColor(Color myColor) { 
// just need to set the value (see setValue()) 
this.myColor = myColor; 

} 

/*}*/ 



} 
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HelloWorldTranslatorjava 

/* XIS Tutorial standalone sequence step 3 data translator class. */ 
/*{*/ 

import com.xis.Ieif.im.AttributeGetRequest; 

import com.xis.leif.im.AttributeSetRequest; 

import com.xis.leif.im.Domain; 

import com.xis.leif.im.Translator; 

import com.xis.leif.im.FieldMetaData; 

import com.xis.domains.display.DisplayDomain; 

import com.xis.domains.movementMovementDomain; 

import java.awt. Color; 

public class HelloWoridTranslator extends Translator { 

// the domains from which canned attribute metadata will be taken 
// NOTE, if an attribute appears in the methods below but its domain 
// is NOT listed here, THE ATTRIBUTE WILL BE IGNORED BY XIS 
private static final DomainQ baseDomains = new DomainQ { 
DisplayDomain.getDomainQ, MovementDomain.getDomain() 

}: 



// store info about the fields, such as whether they are preferred or not 
/ private FieldMetaDataQ field Meta Da taArray; 



[ 



si 



II Return the Domains that describe the Attributes, 
public DomainQ getBaseDomains() { 
retum baseDomains; 

} 

// this method returns info on each field defined in the methods below 
-public FieldMetaDataQ getFieldMetaDataAn-ay() { 

if (fieldMetaDataArray == null) { 

// initialize default metadata 
FieldMetaData dispname = new 
}a \ FieldMetaData(DisplayDomain.displayName); 
FieldMetaData pencolor = new 

FieldMetaData(DisplayDomain.penColor); 
FieldMetaData speed = new 

FieldMetaData(MovementDomain,speed); 
FieldMetaData course = new 

FieldMetaData(MovementDomain,course); 
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Continuation of HelloWorldTranslator.java 

// attributes are visible ('preferred*) by default; this 
// turns this off for the course attribute 
course.setVisibility(false); 

// the order we put the attributes in here determines the order 
// they appear in tables or property sheets 
fieldMetaDataArray = new Fieldl\/letaDataD { 
dispname. speed, course, pencolor 

}; 

} 

return fieldMetaDataArray; 

} 

llllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllll^ 
II the following nnethods expose attributes of the HelloWorld class; 
// instead of calling the class methods directly, XIS will access 
// everything through this translator class 
lllllllllllllllllllllllllllllllllllllllllllllllllllllllllllim 
public String getDisplayName(AttributeGetRequest attributeGetRequest) { 
return ((HelloWorid) 

attributeGetRequest.getRawDataltem()).toString(); 

} 

public Color getPenColor(AttributeGetRequest attributeGetRequest) { 
return ((HelloWorid) 

attributeGetRequest.getRawDataitenn()).getl\/lyColor(); 

} 

public void setPenColor(AttributeSetRequest attributeSetRequest, 
Color penColor) { 
HelloWorid helloWorid = (HelloWorld) 

attributeSetRequest.getRawDataltemO; 
Color oldPenColor = helloWorid.getMyColorQ; 
if (!penCoior,equals(oldPenColor)) { 
helloWorld.setMyColor(penColor); 
// fire property change event to notify other XIS objects 
attributeSetRequest.getBaseDataltem().fireAttributeChanged( 
DisplayDomain. penColor, oldPenColor, penColor, true); 

} 

} 

public double getSpeed(AttributeGetRequest attributeGetRequest) { 
return (double) ((HelloWorid) 

attributeGetRequest.getRawDataltem()).getValue(); 

} 
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Continuation of HelloWorldTranslator Java 

public void setSpeed(AttributeSetRequest attributeSetRequest, 
double speed) { 
HelloWorid helloWorld = (HelloWorid) 

• attributeSetRequest.getRawData ltem(); 
Double oldSpeed = new Double((double)heiloWorld.getValue()); 
if (oldSpeed .doubleValueQ != speed) { 
helloWorld. setValue((int)speed); 
// fire property change event to notify other XIS objects 
attributeSetRequest.getBaseDataltem().fireAttributeChanged( 
MovementDomain.speed, oldSpeed, new Double(speed), true); 

} 
} 

// this is a dummy attribute to demonstrate field metadata 
public double getCourse(AttributeGetRequest attributeGetRequest) { 
return (double) 0; 

} 

/*{*/ 

// uncomment this to allow reflection to expose additional attributes 
// (see documentation under "Fooling Around") 
// public HelloWorldTranslatorO { 
// introspectExcept(new StringQ {"value", "myColor"}); 

// } 
/*}*/ 



} 

/*}*/ 
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TestHarnessjava 
/* XIS Tutorial standalone sequence step 3 XIS interfacing. */ 

import javax.swing JFrame; 

import ja va . a wt. event . Wi ndowAda pter; 

import java.awt.event.WindowEvent; 

import com.xis.propertyslieet.PropertySheetlnfoBean; 

import com.xis.ui.UIBeanEvent; 

import com.xis.ui.UIBeanAdapter; 

import com.xis.leif.im.BaselnfoModel; 

import jclass.chart JCChart; 

import com.xis.plot.PlotlnfoBean; 
:U import com.xis.plotcliartviews.LeifChartView; 
CI IT I 

p import com.xis.ieifJm.TransiatorRegistry; 

y import com.xis.leifJm.LeifDataltem; 

S import com.xis.leif.im.lnfoiV1odel; 

y import com.xis.leif.im,BaselnfoModel; 

Q import com.xis.domains.movement.MovementDomain; 

§1 import com,xis,domains.movement,MovementDomainWrapper; 

n import com.xis.leif.im.LeifDataltemDelegator; 

|n4 import java.lang.reflect.lnvocationTargetException; 

fj import com.xis.leif.im.UndefinedLeifAttributeException; 

ryi 

i II 

p public class TestHarness { 

/*{*/ 

protected static LeifDataltem leifHello; 
static { 

// Register the translator for HelloWorld. In fact this is really / 
// only necessary when we have not followed the standard naming V 23 
// convention (see docs), but it can't hurt. C 
TranslatorRegistry.getTranslatorRegistry().registerObjectSchema( J 
HelloWorld. class, HelloWorldTranslator.class); ^ 

} 

ryi 

public static void main(Stringn args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager(false); 



HelloWorld hello = new HelloWorld(); 
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Continuation of TestHarness.java 

// a property sheet infobean to display HelloWorld's attributes 
PropertySheetlnfoBean properties = new PropertySheetlnfoBean(); 
properties.addRawDataltem(hello); 

// add a listener for 'OK' or 'cancer, which generate 'close' events 
properties, add U I Bean Listener( 
new UIBeanAdapterO { 

public void closed(UIBeanEvent event) { 
System. exit(O); 

} 

} 

); 

// a top-level frame to hold our property sheet infobean 
J Frame property Sheet Frame = new JFramefHelloWorld Properties"); 
// add a listener for window closing 
propertySheetFrame.addWindowListener{ 
new WindowAdapterO { 

public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 

// stick the property Sheet bean in the frame and display it 
propertySheetFrame.getContentPane().add(properties); 
propertySheetFrame.packO; 
propertySheetFrame.setVisible(true); 
// now we create a plot infobean to plot HelloWorld's numeric attribute 
PlotlnfoBean plot = new PlotlnfoBean(); 
plot.addRawDataltems(new ObjectQ { hello }); 
plot.setChartType(JCChart.BAR); 

// the alternatives are SCATTER^PLOT, PLOT, AREA, PIE, CANDLE, 
// and STACKING_BAR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 

// If we do, this must consist of the attribute name preceded 

// by the fully-qualified classname which ORIGINALLY DEFINES 

// the attributeDescriptor — i.e., using "HelloWorld. speed" 

// here will NOT work! If the descriptor is not defined in a 

// domain or translator class, then it will have been defined 

// dynamically through introspection when the first instance 

// of the data item is dropped into an XIS InfoBean. 

plot.setYAxisAttribute( 

"com.xis.domains.movement.MovementDomain, speed"); 
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Continuation of TestHarness java 

plot.setDynamicAdjustment(true); // so axes track value magnitude 
plot.setBarChartAdjusting(true); // needed in some cases for bar chart 

// a top-level frame as before to hold our plot infobean 
J Frame plotFrame = new JFrame("HelloWorld Plot"); 

// stick the plot bean in and put it up 
plotFrame.getContentPane().add{plot); 
plotFrame.packO; 
plotFrame.setVisible(true); 



// create a leifDataltem version of hello and start a thread that 
// will increase it 
leifHello = 

BaselnfoModeLgetBaselnfoModel().getLeifDatallem(hello); 
new AccelerateO; 

/*}*/ 
} // main 

} 



/*{*/ 

// thread to update the speed attribute on the leifHello instance we created 
class Accelerate extends Thread { 

public AccelerateO { 

super("Accelerator Thread"); 
startO; 

} 

public void run() { 

// wrap the LeifDataltem leifHello in a convenience wrapper that 
// gives access to attributes within that domain, if they exist 
MovementDomainWrapper helloMovementWrapper = 
MovementDomain.takeWrapper(TestHarness.leifHello); 



Figure 23D 



Continuation of TestHarness.java 



while (true) { 

// sleep for 0.5 seconds, then.,. 
try{ 

sleep(500); 
} catch (InterruptedException e) { 

System.exit(l); 

} 

// ..update the speed attribute 
try{ 

helloMovementWrapper.setSpeed( 

helloMovementWrapper.getSpeed()+1); 

} catch (UndefmedLeifAttributeException ulae) { 

// exception if this data item doesn't have this attribute 
System.exit(l); // usually we would do something better 

} catch (InvocationTargetException ite) { 

// sweep up any exception tossed by the underlying raw item 
System.exit(l); // usually we would do something better 

} 

}// while 
} // run() 



m 
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HelloWorld.java 

/* XIS Tutorial standalone sequence step 4 data class. */ 

import java.awt. Color; 

import com.xis.leif.im.FieldMetaData; 
import com.xis.dbmains.display.DisplayDomain; 
import com.xis.domains.movement.MovementDomain; 
import com.xis.leif.im. Domain; 
import com .xis . leif i m . AttributeGetReq uest; 
import com.xisJeifJm.AttributeSetRequest; 
import com.xis.leif.im.AttributeDescriptor; 
import java.beans.PropertyChangeSupport; 
import java . beans. PropertyChangeListener; 
/*}*/ 

public class HelloWorid { 

private int value = 1 ; 
private Color myColor = Color.green; 

/*{*/ 

public static AttributeDescriptor getDisplayNameDescriptor() { 
return DisplayDomain.displayName; I 

public static AttributeDescriptor getSpeedDescriptorQ { 
return MovementDomain.speed; 

} 

public static AttributeDescriptor getPenColorDescriptor() { 
return DisplayDomain.penColor; 

} 

/*}*/ 

/*{*/ // this property change support code as in step 2 /*}7 

// this member class helps distribute property change events within XIS 
private PropertyChangeSupport propertyChangeSupport = 

new PropertyChangeSupport(this); 

// two aux methods to let other XIS objects pay attention to this one 
public void addPropertyChangeListener(PropertyChangeListener I) { 
propertyChangeSupport.addPropertyChangeListener(l); 

} 

public void removeProp6rtyChangeListener(PropertyChangeListener I) { 
propertyChangeSupport.removePropertyChangeListener(l); 

} 
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Continuation of HelloWorldjava 

public String toStringO { 

return "A HelloWorld Object"; 

} 

public String getGreetingO { 
return "Hello World!"; 

} 

public int getlDQ { 
return 5; 

} 

public int getValueQ { 
return value; 

} 

/*{*/ // this function as in step 2 /*}*/ 
public void setValue(int value) { 
// we only want to update and fire property change if really changes 
if (this.value != value) { 
int oldValue = this.value; 
this.value = value; 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePropertyChange("value". oldValue, value); 

} 

} 

/*{*/ 

// "nnyColor'*-related methods changed to expose "penColor" instead 

public Color getPenColor() { 
return nnyColor; 

} 

public void setPenColor( Color penColor) { 

// we only want to update and fire property change if really changes 
if (penColor != this.myColor) { 

Color old PenColor = this.myColor; 
this.myColor = penColor; 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePropertyChange("penColor", 

oldPenColor, penColor); 

} 

} 
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Continuation of HelloWorld.java 

// expose toStringO return under a new nanne 
public String getDisplayName() { 
return toStringO; 

} 

// expose "value" under a new name 
public double getSpeed{) { 
return (double) getVaIue(); 

} 

public void setSpeed(double speed) { 

// we only want to update and fire property change if really changes 
Double oldSpeed = new Doubie((double)this.getValue()); 
if (speed != oldSpeed. doubleValueO) { 
setValue((int)speed); 

// fire properly change event to notify other XI S objects 
propertyChangeSupport.firePropertyChange("speed", oldSpeed, 

new Double(speed)); 

} 

} 

/*}*/ 
/*{*/ 

// store info about the fields, such as whether they are preferred or not 
private static FieldMetaDataQ fieldMetaDataArray; 

// this nnethod returns info on each field defined in the methods below 
public static FieldMetaDataQ getPieldMetaDataAnrayO { 

if (fieldMetaDataArray == null) { 
// initialize default metadata 
FieldMetaData dispname = new 

FieldMetaData(DisplayDomain.displayName); 
FieldMetaData pencolor = new 

FieldMetaData(DisplayDomain,penColor); 
FieldMetaData speed = new 

FieldMetaData(MovementDomain.speed); 
// could customize the field metadata here 
fieldMetaDataArray = new FieldMetaDataQ { 
dispname, speed, pencolor 

}: 

} 

retum fieldMetaDataArray; 

} 

/*}*/ 
} 
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Class ContentlnfoBean 

I 

+ — jay a ._awt . Co mpo neat 
I 

+ — j^va . awt . Container 
I 

+ — 3 a vax . s wing . JComponent 
I 

I 

+ — £pm . xi s . ui . A bstractUXBean 
I 

+ — cpm^xi le.i.f ; .igfa^ana . DaXa-I£emgj. nJ^CLlgeaa 
t 

+- -com . xis , inf obesuis . content . ContentlnfoBean 

All Implemented Interfaces: 

Accessible. BeanContextChiidOwner . BeanContextChildOwnerPelegator . BeanContextProxy . 
Bean Context Ser vi cesQ wn erDeleg ator Clipboard User . DataitemJSink, ImageOJbserver, MenuCpntainer, 
. Serialtzable . StateSavable . UIBean 



public class ContentlnfoBean 
extends DataLte mSin k UIBea n 
implements Cli pboardUser 

The ContentlnfoBean class is a visual component that displays the contents of a raw data item, if no contents are 
available^ it defaults to a split pane containing the JAF menu and the PropertySheet of the raw data item. The contents 
may have be multipart, and may be text, html, rich text, or an image. Multimedia support will soon be added. 

Author: 

Jaime Garcia, Polexis, Inc. 
See Also: 

Serialized Form 



Inner classes inherited from class javax.swing.jnPanel 

JPanel . AccesaibleJPanel 



Inner classes inherited from class javax.swing.JCom ponen t 

JComoonent. Access i bleJComponent 



Inner classes inherited from class java.awt-Contajner 



Con 



inner classes inherited from class java.awt^ Component 
Component .AccessibleAWTComoonent 



Field Summary 




RESOURCES 




localized resources for this view object. 



Fields inherited from class com,xis«ui. AbstractUIBean 
uibaanLi^stenei; 



Fields inherited from class javax.swing.JComppnent 

accesai bleCQntex t . lis tenerL ist . TOOL_TIP_TEXT KEY , ui, CJNO£F:^NED_CON DITION > 
WH E ti_ANC£ STQR_0 F_ FOCU S E D _COM PON ENT , WHEN^F OCUS ED. WHEN^IN_F0CU5Ed'"_WINDQW 



Fields inherited from class java.awt.Coniponent 

BQTTQM^ALIGNMENT. g^TM-^ LXQNjlEN T , lZJXJ<hlGmmLt RI-GHl^ ALIGNMENT. IQP^LIGNMENT 



Fields inherited from interface java.awt.image. ImageQbserver 

ABORI, ALLBITS. ERROR . FRAMES ITS . H EIGHT , PROPERTIES , SOMEBITS . WIDTH 



Constructor Summary 

Contentlnf oBean { ) 

Default constructor that creates an empty ContentlnfoBean, 



Method Summary 


void 


addRawDa ta I tsm. { Ob 1 e c t r a wDa t a 1 1 em) 

Load the raw data item into the ContentlnfoBean. 


void 


addRawDa-baltems (Object [ } rawOataXtems ) 
Add the raw data items in the array. 


boolean 


canCIear ( ) 

Return tnie if the ContentlnfoBean has an object and it is selected 


booiean 


canClear (Obiect [ 1 items) 

Return true if the specified items can be cleared. 


boolean 


canCopy ( ) 

Return true if the ContentlnfoBean has an object and it is selected 


boolean 


qanC opY ( Ob 3_ect [ j i t ems ) 

Return true if the specified items can be copied. 


boolean 


canC_ut { ) 

Return true if the ContentlnfoBean has an object and it is selected 


boolean 


canCut (Obi ect [ 1 items) 

Return true if the specified items can be cut. 


boolean 


canPaste ( } 

Return true if the ContentlnfoBean can paste new objects, false if not. 


boolean 


canSelectAll { ) 

Remm true if the ContentlnfoBean can select all objects. 




boolean 


CAnSeiect^_one { ) 

tv,CLurii uuC 11 iJic ^wiikctiLiiiivuCcin wan uu'acicui an uujCwld. 


void 


clear ( } 

iNuiuy uic v^u[iiciiLi iiivjocau vj rcmuvc uic wuirciH law uaid iLcm uniy ii ii is SClcClCu. 


void 


clear (Object [ ] items) 

f^lp^ir? fhe oriven item^ 


void 


clearAll ( ) 


boolean 


contains (Obi ect [ 1 items) 

Return true if this ContentlnfoBean contains all the objects of the given array. 


boolean 


containsComDonent { Comoonent component ) 

Check if thr given component is contained by this InfoBean 


void 


copy ( C I.ipboa^rd clipboard) 

Called to invoke this ContentlnfoBean's copy action, which is to copy all selected data 
to tne uupDoara. 


void 


copv (Clipboard clipboard. Obi ect [1 items) 
wopies ine given iicms inio uic Uiiipuoara. 


protected void 


createContant ( } 

Method called when there is no content to display for a raw data item. 


void 


cutiClioboard clipboard) 

Cut selected items from the ContentlnfoBean and post them into Clipboard. 


void 


cut(Cli,pboard clipboard. Object fl items) 

Cut the given items from the ContentlnfoBean and post them into the given Clipboard 
only if they occur in the ContentlnfoBean. 


ocotected Containei;: 


getContainerForContant ( int index ) 

Get a container with the contents of the content object at the given index, or null if the 
content type is not supported. 


Qbiect 


getCon tents ( ) 

Fetch the currectly loaded raw data item 


J AFAnd P rooe r t vComaon«^n t-_ 


aetJAFAndP rope rtyComoo nan t ( ) 

Get the JAFAndProperty component used by the ContentlnfoBean to display the 
contents for raw data items that have nothing else to display. , 


JXenu 


qetLaifOataXtezsMenu {Leif Dataltem dataltem, boolean showCutPasteltems ) 
Return the data item menu for a LeifDataltem (usually the selected LeifDataltem). 


TvoedResourcsBundie 


aatKesources ( } 

Return the ResourceBundle for this ContentlnfoBean. 




getSelectadOb^ecta ( ) 

Get an array of selected objects. 


void 


InfoModel Changed ( ) 

Messaged to indicate an InfoModel change for this InfoBean or one or more of its 
LeifDataltems. 


boolean 


isCreatingContent ( ) 

unecK wneiner ueiauii conieni crcaiion is sci. 


boolean 


isDragSnabled ( ) 

Return true if the default Drag support is enabled. 


boolean 


isDropSnabled { ) 

Return true if the default Drop support is enabled. 



boolean 


isSelected ( } 

Check the selected state of the content object, if there is currently one loaded. 


boolean 


isXISNotifyingO 

Check whether the ContentlnfoBean is updating based on XIS events and is notifying 
XIS of raw data item attribute changes 


void 


paste (Cl ioboard clipboard) 

Paste the data Objects from the given clipboard. 


void 


removeAllRawDatal tents i ) 

Remove a)I of the raw data items that are -currently loaded 


void 


removeRawDatalteiti {Object rawDatal tem) 

Rf^mnvf* thf* oi'vpn riafa itpm tFtt i« r*» irrf^nf Iv lr\nrl#»H ravw rlnfn it**m 
rvciiiUVw uiC glYdi law uaLa iidll ki IL Id illC UUrrwllLIY lUclUCU raw U<lUa iLcm 


void 


^removeKawDatal terns (Obiect f 1 rawDatal temsl 
Remove the raw Hnta item^ in the arrav 


void 


selectAli ( ) 

Set the selection state of the object to true. 


void 


selectMone ( ) 

Set the selection state of the object to false. 


void 


setCreateContent (boolean create) 

Set whether content should be created for objects that do not have any dispiayable 

rnn^pnt via 3 T A PAnHPrnnprlvf^rtrnnrinpnt 


void 


5etDrag£:nahled(boolean enabledrag) 

fh^ etahie nf* fhp Hpfaiilf Piraty Qiinnnrt 

OCL UlC aLallM UI vllC UCtaUll 1.^1 3Upp^Jt 


void 


se tDr ago wner Proxy ( DragOwner drag Proxy) 
Set a OraoOwner "nroxv" for this InfoBean 


void 


setDrgpEnaiLled ( boo 1 ean enab 1 edrop ) 
fs&t the status nf the default Dron sunnort 


void 


setDrooOwnerProxv ( DrooOwner drooProxy) 
Set a DropOwner "proxy" for this Info Bean. 


void 


setSelection (boolean selected) 

Set the selection state of the content object 


void 


setXISNotifying {boolean notify) 

Set whether the ContentlnfoBean should update based on XIS events and should notify 
XIS of raw data item attribute changes 



Methods inherited from class com.xisJeifjnfobeans.DAtaJleiBSjnkUJfea^ 



ad dJAy populator, addRaw Dat altemsAsGrou p, ad dServi ce^ close , 
creat eBeanCon text ServicesOwnerPeleg a tor , d ispose , getB eanC o n text Pro xy , 
.qetSean ContextServices . getEzContext / getinf pModel « get J A FPopulators , 
g.etLe_i f Da t a 1 1 emM e nu , g etLelf Da taltemMenu, ge tL eif DataltemM enu , ge t Menu Bar, 
q etOwgedBeanContextChild . g etService , getService , getService , aetS tatus Bars > qet ToolBars . 
q etU Is , ia i t la l ize BeanCon te xt Resources / initializeBeanC onte xtSer vlces , 
invalidate lnf oModel , is DrppPasteEn abled , isHandlingClipboardOperations , 
releaseB ean ContextRe s purees . releas eB eanC on textSe rv ices , revokeAnchoredPialo gProvider, 
revQk_e_ Frame P ro v ide r . r evo keService/ setPro pPa steEnabled, setHandlinaCli p boardO perat ioa s . 
.mlldatJlendijTaS^^^ 



Methods inherited from class com.xis.ut. Ab stractUIBean 



iddyjBe anLj^. ene r , finalize, ge tSho rtTitle. getTitie, getUIC omponent s . isActive. 
i sClosed . isCJLoseOK, processUIBeanEvent > removeCJIBean Liste ner, restoreSt ate. saveState . 
setActive, set ShortT i ti e. set Title 




Methods inherited from class javax^swing. JPanei 

qetAccessibleContext. aetUIClasalD. parainSt;r j.r\g, uodateUI 



Methods inherited from class javax.S'vving. JComponent 

adcLAncestorLis tener . addNotif v , addPropertvChangeLis tener , addPropert vChanoeListerier . 
addVetoableChangeLis tener . computeVis ibleRect , contains , createToolTip , disable , enable . 
f i rePropertvChanae , f ire P rope rtyChanqe . f ire Proper tyChange , f ire Proper tvChanae . 
f irePropertvChanae . firePropertyChange , f ire Proper tvCha age , f irePropertvChange . 
fire Proper tvChanae , f ireVetoableChange , getAct ion For Keystroke , getActionMap . 
g etAlignmentX , ge tAl ignmentY , getAuto3croIl5 , getBorder , getBounds , ge t Client Proper ty . 
getComponentGraohics . getConditionForKevStroke . get DebugGraphicsOot ions , getGraohics , 
getHeight , get InputMap , getlnputMap . getlnputVerif ier . getlnsets , get Insets , 
getListeners > getLocation . getMaximumSize , getMinimumSize , getNext Focus ableComponent . 
getPref erredSize . getRegisteredKevS trokes , getRootPane , getSize , qe tToolTipLoca t ion . 
getTooITipText , getToolTipText , getTopLevelAncestor . getVerifylnputWhenFocusTarget > 
getVisibleRect > getWidth , getX , getY , grabFocus , hasFocus , hide , isDoubleBuf fered . 
isFocusCvcleRoot . isFocusTraversable , isLightweightComponent , isManagingFocus > 
isMaximumSizeSet , isMinimumSi zeSet > isOoague ^ isOptimizedPrawingEnabled . isPaiatmgTile . 
isPref erredSi zeSet . isReguest Focus Enabled , isValida teRoot . paint , paintBorder . 
paiatChildren . paintComponent , paint Immediately , paint Immediately , print , printAll . 
printBorder . orintChi Idren , printComponent , processComponentKevEvent . process Focus Event . 
process KevBindina , processKe vEven t , processMouseMot ionEvent , putCl lent Property , 
registerKevboardAct ion , regis terKevboardAct ion , removeAnces torListener , removeNotif y , 
removePropertvChangeLis tener , r amove P rope rtvChange Listener , removeVe toableChangeLis tener . 
repaint , repaint , requestPe fault Focus , reauestFocus , res etKevboardAct ions , reshape , 
revalidate, ^crollRegtTcV^s j.blQ, ^^etActipnMap, SQt;Al3,qnmentX, 5gt;A;i,qrvner>tY, 
setAutoscrolls . setSackoround , setBorder , setPebuaGraphicaOptions , setDoubleBuf f ered , 
setEnabl^d, set Font, set Foreground. setlnPUtMap, setlnoutVerif ier . setMaximumSize . 
setMinimumSize . setNext FocusableComponent , setQpaaue , set Pre f erredSize . 

setReauestFQCusEnataled. aetToolTioText , setUI. setVerif vlnputWhenFocusTarget . setVisible . 
unreaisterKevboardAction . update 



Methods inherited from class java.awt,Container 

s.dd, add, add, add, add, addCo nta iner Lis tener , addl mpl , coun tComp onents , delive r Event , 
doL ayqut , fin. dC omp o n e n t A t , f indCompo nen tAt , qetComponent . g e tC omp onentAt , qe tComponentAt . 
9.stComEonejitCount get Components, getL ayout , in set s , invalida te, isAncestorOf . ia^jut, 
.List, list, locate, minimum Size , paintCompone nts , pref erredSiz e, printComp onen ts , 
proce ssContainerSvent , proc essEvent , remove, remove , r emo ve Al 1 , remov e ContainerLis ten er. 
se tLay out . val idate , validateTree 



Methods inherited from class java.awt.C_omponent 

sctjLon, a_dd, addCQmpo aent ll^i.s t;eri.e iTi addFoc us Lis tener » addH ierarchyaoun ds Lis ten er, 
addHie ra rch vLi s te ne r . addlnputM e thodLis tener . addKeyLiatener , addMouseLis tener , 
addM ouseMotionListe ner, bounds , checklmage, check lmage, c oalesceEvents , c ontains , 
cre atelmag g. create Im age, disableEvents , dispa tchEvent , enable, enableEvents , 
ena bleln put Methods . getBa ckgrou nd, get Bounds , g etColor Model . g etComponentOrientatio n . 
getC ursor . g e tOrop T arget . getFont , get F ontM e tries, getFor eground , 
.ge tG r a p hic s Con f i gu ration , get InputCon t ext, getlnp utMe th odRe quests, get Locale, 
getLo catio n , getLocat ionOnScreen , getName, g etParent , g etPe er , getSize , ge tToolki t , 

t Txse L^ck , got Fo cus . h andleE v ent , imageUo date , inside . isDisplayable, is^nabied, 
isLightwe iqht , isShowj ng, isVaiid, i s V.i^sJ:b.l_e , keyPown, keyUp, l ist , list, list, locat ion, 
los t Focus . mousePown, mousePrag , mouseEnter , mouseExit , mouseMove , mouseUp , move , 
Uex_&.£ocus, paintAll , postEvent , prep arelm age , prep a re I mage , prpcessCompo nentEvent , 
PXQc esjiUe^a rchyBo^in^^ , p r oce s sH i er a r chvE vent , process I np ut MethodE vent , 

fi.tQcesjMoji.3eExsnt rem ove , r emov eComponentLi s tene r, r emove Foc u s Lis tener , 
£ smgveH_iej'a r,(^y B.O uji_^ sLis tener , removeH ierarchyLis te ner , remove In putMethodLis tene r , 
-?:emp_veKey Li5_t ener ^ re moveMouse Lis ten er, re move Mous eMotionListe ner , repa int , re paint , 
Esp.aint, .re.3.ize, resi.ze., s_e_t Bounds, se tBo unds , setCo mponentOrientation , setCursor . 
se_tProp.Ta rg:e t / set Locale , setLo cation, setLocation . setName , setSize , setSize . show , 
siiaw. size, to.Strin.g, transf erFQSag 



Methods inherited from class java.lang.O bject 

cloog., equals . getClass , hashCode , no"i f nqtif vAll , wait , wait , wait 

Methods inherited from interface com. xis.ui. Clipboard User 

isHandl inaCliDboardODe rations , setHandl ingCl ipboardOoerations 

Methods inherited from interface com.xis.ui.yiBean 

.4 gi-d P rope r t y Cha ng eL i s t e ner , r emgve P rope rXyChjangjg Li stener 

Field Detail 

RESOURCES 

public static final TvpedResourceBundle RESOURCES 
localized resources for this view object. 

Constructor Detail 

ContentlnfoBean 

pub lie Con ten tinf oBaan { ) 

Default constructor that creates an empty ContentlnfoBean. 

Method Detail 

getContents 

public Qbiect getContants { ) 

Fetch the currectly loaded raw data item 
Returns: 

the currently loaded object, or null if no object is loaded 
setXISNotifying 

public void setXISNotifying {boolean notify) 

Set whether the ContentlnfoBean should update based on XIS events and should notify XIS of raw data item 

attribute changes 

Parameters: 

notify - if true then notify XIS, else do not 



isXISNotifying 

public boolean isXISNotif ying ( } 

Check whether the ContentlnfoBean is updating based on XIS events and is notifying XIS of raw data item 

.attribute changes 

Returns: 

true if it is notifying XIS, else false 



removeAllRawDataltems 

public void removeAlXRawOatalbems { } 

Remove all of the raw data items that are currently loaded 



getResources 

public Ty pedR esourceB undl e getRs sources { ) 

Return the ResourceBundle for this ContentlnfoBean.. 
Overrides: 

getResources in class Dat altemSi nk UIBean 
Returns: 

the statically sourced ResourceBundle. 



infoModelChanged 

public void inf oModelChanged ( ) 

Messaged to indicate an InfoMode! change for this InfoBean or one or more of its LeifDataltems. This should 

reload all currently loaded data items to pick up InfoModel changes. \ 

Overrides: 

infoModelChanaed in class DataltemSinkUISean 



addRawDataltems 

public void addRawDataltems (Object ( ] rawDatal terns } 

Add the raw data items in the array. Will only add if the array has only one object and the object is not the 

currently loaded rawDataltem. 

Parameters: 

rawData Items - the array of objects to be added 




addRawDataltern 

public void addRawD a ta I tarn ( Ob i e c t rawDataltem) 



W 



Load the raw data item into the ContentlnfoBean. If the raw data item supports the ContentDomain and has 
content of type that is currently supported then it will be displayed. Otherwise, if content creation is set to true then 
default content will be created, using a JAFAndPropertyComponent 
Overrides: 

addRawDataltem in class Pat a I temS in kU I Bean 
Parameters: 

rawDataltem - the raw object to display 



createContent 

protected void createContent ( ) 

Method called when there is no content to display for a raw data item. The default behavior displays a 
JAFAndPropertyComponent of the object, but subclasses may wish to display something else instead, 

isCreatingContent 

public boolean IsCreatingContent ( } 

Check whether default content creation is set. If so then a JAFAndPropertyComponent will be created for items 

that have no displayable content. 

Returns: 

true if default content is created, else false 



setCreateContent 

public void setCreateContent (boolean create) 

Set whether content should be created for objects that do not have any displayable content, via a 

JAFAndPropertyComponent. 

Parameters: 

create - if true, create content, else do not 



removeRawDataltems 

public void removeRawDatalteiaa I0bje££ [ ] rawDatal terns ) 

Remove the raw data items in the array. Will only remove the object that is currently loaded if it is contained in die 
array 

Parameters: 

rawDataltems - the array of objects to be removed 



removeRawDataltem 

public void removeRawDa tal tem ( Obi ect rawDataltem) 



Remove the given raw data item if it is the currently loaded raw data item 
Overrides: 

remoyeRawDaJiartem in class Qata 1 1 emjlin kU I.Bean 
Parameters: 

rawDa tart em - the object to remove 



getJAFAndPropertyComponent 

public Jft FAndP cope r t yComponen t get JAFAndP roper l:yComponent ( ) 

Get the JAFAndProperty component used by the ContentlnfoBean to display the contents for raw data items that 

have nothing else to display. 

Returns: 

the current JAFAndPropertyComponent being used 



getContainerForContent 

protected Contaiaer getContainerForContent ( int index) 

Get a container with the contents of the content object at the given Index, or null if the content type is not 

supported. Subclass this if you need support for a type that is not already supported. 

Parameters: 

index - the index of in the object 
Returns: 

a Container with the contents at the given index 



getSelectedObjects 

public Object [ 1 getSelectedObjects ( ) 

Get an array of selected objects. This will return an empty array if there are no selected objects. If the raw data 

item is selected it will return an array of size 1 with the raw data item Inside 

Returns: 

an array of selected objects 



isSelected 

public boolean isSelected {} 

Check the selected state of the content object, if there is currently one loaded. If there is none, return false. 
Returns: 

true if there is an object and it is selected 



selectAll 

public void selectAll O 



Set the selection state of the object to true. 
Specified by: 

selectAll in interface ClipboardUser 
Overrides: 

selectAil in class Data ltemSinkUISean 



selectNone 

public void selectNone 0 

Set the selection state of the object to false. 



setSelection 

public void setSelection (boolean selected) 

Set the selection state of the content object 
Parameters: 

the - new selection state 



canClear 

public boolean canClear { } 

Return true if the ContentlnfoBean has an object and it is selected 
Specified by: 

canClear in interface ClipboardUser 
Overrides: 

ca nCle ar in class D ata Items in kUIBean 
Returns: 

true if the raw data item is selected 
See Also: 

getS elfected Ob jects ( ) 



canClear 

public boolean canClear (Qbiestf ] items) 

Return true if the specified items can be cleared. If the item is not in the ContentlnfoBean return false. If there is 
more than one item return false. 
Specified by: 

cjuaClggjc in interface ClipboardU ser 
Overrides: 

canCleair in class DataltemSinkmSean 
Parameters: 

items - the Array of items to be cut. 
Returns: 

true if^all of the items are present, otherwise false. 
See Also: 



0 Tiffufi^- 



canCopy 

public boolean canCopyO 

Return true if the ContentlnfoBean has an object and it is selected 
Specified by: 

caaCopy in interface ClipbQar(lUser 
Overrides: 

canCoDv in class Da tal temSinkUIBean 
Returns: 

true if the raw data item is selected 
See Also: 

canCl&ar;/ 



cahCopy 

public boolean canCopy {Object [ ] items) 

Return true if the specified items can be copied. If the item is not in the ContentlnfoBean return false. If there is 
more than one item return false. 
Specified by: 

canCoDv in interface ClioboardUser 
Overrides; 

canCopy in class Da tal t emSinkUIBe an 
Parameters: 

items - the Array of items to be cut. 
Returns: 

true if ail of the items are present, otherwise false. 
See Also: 

canClear ^Object [] ). 



canCut 

public boolean canCutO 

Return true if the ContentlnfoBean has an object and it is selected 
Specified by: 

canCut in interface ClipboarciUser 
Overrides: 

canCut in class Data Items inkUIBean 
Returns: 

true if the raw data item is selected 
See Also: 

canClear { ) 



canCut 

public boolean canCut ( Obi ect [ 1 items) 



Ti^fiL^- ^ it- 



Return true if the specified items can be cut. If the item is not in the ContentlnfoBean return false. If there is more 
than one item return false. 
Specified by: 

c a nC u£ in i nterfac e C 1 x jJbo a r dU s §.r 
Overrides: 

canCut in class DataltemSinkUIBean 
Parameters: 

items - the Array of items to be cut. 
Returns: 

true if all of the items are present, otherwise false. 
See Also: 

canClear iObj [ J J. 



canPaste 

public boolean canPaste () 

Return true if the ContentlnfoBean can paste new objects, false if not. 
Specified by: 

canPaste in interface ClipboardUaer 
Overrides: 

canPaste in class DataltemSinkUIBean 
Returns: 

default is always true for the ContentlnfoBean. 



canSelectAU 

public boolean canSelactAlK ) 

Return true if the ContentlnfoBean can select all objects. 
Specified by: 

canSelectAll in interface Clipboa rdUser 
Overrides: 

canSelectAll in class DataltemSinkUIBean 
Returns: 

returns true if there is an object and it is not selected 



canSelectNone 

public boolean canSelectNone ( ) 

^Return true if the ContentlnfoBean can un-select all objects. 
Returns: 

returns true if the raw data item is selected 



clear 



public void clear 0 



Notify the ContentlnfoBean to remove the current raw data item only if it is selected. 
Specified by: 

clear In interface CliuboardUser 
Overrides: 

clear in class DaJiartemSijikyjBean 



clear 

public void clear ( Qbiect f I items) 

Clears the given items. These items only get cleared if they actually occur in the ContentlnfoBean. 
Specified by: 

cl_e.a.r in interface ClipboardUseLr 
Overrides: 

clear in class Data Items in kUIBean 
Parameters: 

items - the items to cleared 



clearAIl 

public void clearAllO 

. Removes the currently loaded object. 



copy 

public void copy ( Clipboard clipboard) 

Called to invoke this Contentlnfo Bean's copy action, which is to copy all selected data to the Clipboard. 
Specified by: 

cop^ in interface ClipboardUser 
Overrides: 

copy in class DataltemSinkUIBean 
Parameters: 

clipboard - the Clipboard object that gets posted to. The actual items posted are contained in a 
LeifTransferable. 



copy 

public void copy (Cli pbo ard clipboard, 
Object [ ] items) 

Copies the given items into the Clipboard.. 
Specified by:' 

copy in interface clipboardOser 
Overrides: 

copy in class PataJjtgmSJjlkyifigan 
Parameters: 

clipboard - the Clipboard object that gets posted to. The actual items posted are contained in a 




LeifTransferable. 

Items • the array of Object items to copied. 



cut 

public void cut (Clipboard clipboard) 

Cut selected items from the ConteminfoBean and post them into Clipboard, 
Speciried by: 

cut in interface ClioboardUser 
Overrides: 

cut in class DaAaIj:,gmSi.n]cUIBe5Q 
Parameters: 

clipboard - the Clipboard object that gets posted to. The actual items posted are contained in a 
LeifTransferable. 



cut 

public void cut f Clipboard clipboard, 
Object CI items) 

Cut the given items from the ContentlnfoBean and post them into the given Clipboard only if they occur in the 

ContentlnfoBean. 

Specified by: 

cut in interface ClioboardUser 
Overrides: 

cut in class DataltemSi nkaiBean 
Parameters: 

clipboard - the Clipboard object that gets posted to. The actual items posted are contained in a 
LeifTransferable. 

items - the array of Object items to cut and posted. 



paste 

public void pasta {Cl ipboard clipboard) 

Paste the data Objects from the given clipboard. This retrieves the clipboard contents and does a simple add. 
Specified by: 

paste in interface ClioboardUser 
Overrides: 

paste in class DataltemSi nkUIBean 
Parameters: 

clipboard - the Clipboard that contains the objects, 
See Also: 

a-ldr^awDataltertis (Ob] act [ ] ) 



contains 



public final boolean contains ( Obi ect 1 1 items) 



Return true if this ContentlnfoBean contains all the objects of the given array. 
Parameters: 

items - an array of objects to locate in the ContentlnfoBean. 
Returns: 

true if there is only one object and it is contained, false othe^^vise 



containsComponent 

public boolean containsComponent { Compcnant component) 

Check if thr given component is contained by this InfoBean 
Parameters: 

component - the Component to checic for 
Returns: 

true if it is contained, else false 



getLeifDataltemMenu' 

public JMenu getLeifPatal tainMenu ( LeifPataltem dataltem, 

boolean showCut Paste I terns) 

Return the data item menu for a LeifDataltem (usually the selected LeifDataltem). This is used by the menubar to 
add menuitems from this JMenu to a Data menu if there is exactly one DataltemS elected selected. 
Overrides: 

getLe ifD ata ltemMenu in class DataltemSinkaiBean 
Parameters: 

dataltem - the LeifDataltem to get the menu for 

showCut Paste I terns - true to allow cut and paste items to appear, false to omit them. 
Returns: 

the JMenu for the given LeifDataltem 



isDragEnabled 

public boolean j.sDrag£nabled ( ) 

Return true if the default Drag support is enabled. 
Overrides: 

isDragEnabled in class D ataltemSin kUIBean 
Returns: 

true if drag is enabled, false if not, default is initialized to true. 



setDragEnabled 

.public void setDragEnabled (boolean enabledrag) 

Set the status of the default Drag support. 
Overrides: 

setDragEnabled in class DataltemSinkUISean 
Parameters: 



enablsdrag - true if default drag support should be used, false if not. 



setDragOwnerProxy 

public void setPraqOvnerProxv ( DraaOwaer dragProxy) 

Set a DragOwner "proxy" for this Info Bean. 
Overrides: 

setPragOwaer Proxy In class Datal temSinkUIBean 
Parameters: 

dragProxy - a DragOwner implementation. 



isDropEnabled 

public boolean isDropEnabled ( ) 

Return true if the default Drop support is enabled. 
Overrides: 

IsDropEnabled in class DataltemSinkUIBean 
Returns: 

true if drag is enabled, false if not, default is initialized to true. 



setDropEnabled 

public void setDropEnabled (boo lean enabledrop) 

Set the status of the default Drop support. 
Overrides: 

setDro pEna bled in class Datalte mSinkUIBean 
Parameters: 

enabledrop - true if default drag support should be used, false if not. 



setDropOwnerProxy 

public void setPropOvner Proxy { OropQwner dropProxy) 

Set a DropOwner "proxy" for this InfoBean. 
Overrides: 

S etDropOwnerProxy in class DataltemSinkCJIB ean 
Parameters: 

dropProxy - a DropOwner implementation. 




Package com.xis.leif.im 

This package contains classes that provide the APIs for using information management in applications. 



See: 

Description 



Interface Summary 


Attribute 


The Attribute class represents an attribute for a particular data type. 


ritirwuie/nius 


The AttributeAlias indicates an alias ft-om l-.n Attributes to a single Attribute, together 
with a precision level; the higher the precision, the better the alias. 


A ttrib it te Factory 


The At tribute Factory class allows an impiementor to return an appropriate Attribute for 
the given LeifDataitem. 


d ttributeLookiip 


The AttributeLookup interface is used to lookup Attribute objects for a particular data 
item. 


PjspJoxLgbei 


The DisplayLabel Interface defines methods that are needed for use with 
DisplayLabelAttributes, 


Domain 


This interface describes the basic fields and methods possessed by all Domains. 


Info Model 


The inf oModel interface is the interface that is used to convert raw data items into 
Lei fDatal terns. 


Lei fD at a I tern 


The LeifDataitem interface represents a simple data item. 


LeifDatalternObserver 


This class is used for observering a LeifDataitem to know when it has finished processing an 
action. 


Li/eDatafiem 


The Li t e Da t alt em interface represents a data item. 


PropertvProvider 


If a Property Provider implementation is added to services it can be used to replace the 
standard behavior when a PropertySheetView is opened from a JAF menu or as a default 
command. 


RawDataltemLookiip 


The RawDataltemLookup interface is used to look up a raw data item from a unique id. 



Class Summary 


Abstract A ttribu te 


The AbstractAttribute class represents an Attribute. 


AttributeAliasPluggableService 


This register AttributeAliases. 


AttributeDescriptor 


The AttributeDescriptor class is used to describe an 
attribute without providing functionality of how to use the 
attribute. 


AttributeOescriptorFactory 


The AttributeOescriptorFactory class is a singleton 
class used to create or get AttributeDescriptors. 


A.ttrib u teFaplo ry,ln foM o.d elSiibset 


The AttributeFactorylnfoModalSubset class 
provides an InfoModel that will add the Attributes specified 
by the AttributeFactories to all LeifDataltems this 
InfoModel creates. 




AttributcGetReq uest 


The AttributeGetRsquest class is used to package all 
the necessary parameters for getting the value an attribute. 


AttributeLockRequest 


The AttributeLockRequesc class bundles attributes 
needed to gain access to locked LeifDataltems. 


Attributes 


The Attributes is a container for holding attributes. 


A tt r i b u t eSetReq ues t 


The AttributeSetRequest class is used to package all 
the necessary parameters for setting an attribute. 


BaseDataftem 


The Base Da tal tern is the fu-st wrapper around raw data 
items. 


Basel iifoiVIodel 


//PENDrNGCRJCV Anv method marked with "PENDrNG" in 
the JavaDoc will //likely be removed before XIS is released 
In fmal form. 


BaselnfoModeiSemcesProvidcr 


The BaselnfoModelServicesProvider class will 
provide all the services available from the BaselnfoModel 
to the given BeanContextServices object. 


Co 11 e c t i 0 n P ro p e r t i es 


This class populates JAFMenus for generic collections. 


Da tal t e m A_ctigit M a nager , 


The DataltemActionManager class provides some useful 
static methods for dealing with actions on LeifDataltems. 


DataltemActionManager.LeifReferenceActionListener 


This class is an actionListener to be used with 
LeifReference "Load" menus. 




Da ta I tern M e n uSe t 


TTie Da t- 3 Tr s»mMenuSet ciass is used bv the 
LeiflAFUtilities class to return essentially a Dataltem 
popup menu with annotation. 


DaUUeniiyienuSet.Ejitry 


The Daf a r tpmMenuSet Entrv class encaosulates a 
Dataltem and it's menu, and also provides some 
convenience methods for adding additional menu items. 


DefauItWrapperAttribute 


TTh^ nofjaiti t-w rarvno-rJit* t* r i Hn^ f* class is a generic 
attribute that is the superclass of ail defaults in generated 
domain attributes. 


DisplavLabcIAttribute 


one or more Attribute values in conjuction with string 
literals specified by users. 


Eli 3 y. Lia.j^e 1 D a t a 


The DispiayLabelData class is used by the 

rv-i 1 A \tT a 1 at" i- T- 1 Hii -h ca tn ^trtre a manninp of* 

LeifDataltems to DisplayLabelTemplates. 


DisplayLabelTemplate 


The DisplayLabelTempiate class is used by the 
Oi splay LabelAttribute to compute and store editing 
and renderuig values for every LeifDataltem that has the 
attribute. 


DomainMethod 


Abstractly represents a Domain Method. 


DomainMethodDescriptor 


The DomainMethodDescriptor class is used to describe 
a DomainMethod. 


fio m a i n ^let hod D es^^ 


The DomainMethodDescriptorFactory class is a 
singleton class used to create or get 
DomainMethodDescriotorS. 


DomainWrapper 


This class adds methods to LeifDataltem delegator that are 
useful in the domain wrappers. 


DynamicAttributes 


The DynamicAttributes class is used for storing 

dynamic attributes. 








FieldMetaData specifies sorting and subset criteria for an 

attribute. 




FieiUMetaPatas 


The FieidMetaDatas class represents a coUection of 
FieldMetaData for a data item. 




InroModeiDataltem 


The inf oModeiDataltem allows views to wrap 
LeifDataltems and add/remove/modify attributes that will 
only affect that view. 




inrolVlodelSubset 


Typically when creating an InfoModel to nest within an 
existing InfoModel, which is done by'ViewUlBeans, an 
InfoModelSubset is used. 




In valid WrapperAttribute 


The In valid WrapperAttribute class 




LiCirOataltemComparator 


The LeifDataltemComparator compares LeifDataltems by 
AttributeDescriptor supplied by the user. 




LeirDataltemDelegator 


Implements the methods in LeifDataitem in a wrapper so 
you don't have to. 




Lei. [Datal temSorter 


The LeifDataltemSorter provides a default sorting tool for 
all LEIF LeifDataitem objects. 




LeifDataltemUpdate 


This classes is used with the LeifDataltemObserver. 


Leiflnitialization 


The Leiflnitialization class handles some standard 
initialization for most XIS Applications. 


(1 


LeifJAFUtilities 


The LeifJAFUtilities class provides some useful static 
methods for LEIF-related JavaBeans Activation Framework 
(JAF) processing. 




LeifJAFUUiitjes,LeifBeferen^ 


This class is an actionListener to be used with 
LeifReference "Load" menus. 




LeifRequest 


The LeifRequest class is used to package all the 
necessary parameters for requesting information for a 
LeifDataitem. 


p. ? 
J 


LeiXr.ra nsa ctipn 


The LeifTransaction class is used to construct a 

transaction. 




l.nfkoHI ptfTln^'nltpm 


The Log kedLe if Datal tem class is used to enable locking 
on the data item. 




MethodRequest 


The MethodRequest class is used to package all the 
necessary parameters for invoking a DomainMethod for a 
LeifDataitem. 




MutableAttributeDescriptor 


Mutable subclass of AttributeDescriptor. 






This class provides useful support for using the 
LeifDataltemObserver. 




RequestPool 


The RequestPool class is used to assist Object pooling. 




Resources 


The Resources class is automatically generated and must 
be public, but it is intended to be used only by Java's 
internationalization support classes. 




e c ta bieDa ta Ijte m 


Creates a wrapper around a LeifDataitem for a 




SelectablelnfoModel 


Manages selections for the selectable leif data items that are 
contained within this model. 




Iransjaior 


A major design goal for XIS was to provide the ability to 
integrate existing data item classes without modifying them. 



T ra ns la to r Reg islry 


Provides a central location for maintaining Translators, 
extended Translators and locating Domain methods on data 
items. 


UndefinedAttribute 


The UndefinedAttribute class represents an undefined 
attributes. 


Y isibility AUribiiJe 


The visibilityAttribute class is an Attribute that is 
ready to use for LeifDataltem visibility. 



Exception Summary 


DataltemNotFound Exception 


The DataltemNottoundException class is an exception that can be thrown 
when trying to look up a data item from an Id 


Inva 1 idO b j ec tSch em a E xcep tip n 


Signals that there was a problem with the creation or modification of an 
ObjectSchema. 


TransiatorException 


The TransiatorException class 


UnconvertibleAliasExceptlon 


Indicates that the requested attribute alias could not be calculated or converted. 


UndennedLeifAttributeEx'ception 


Indicates that the requested attribute is not applicable for the object. 


Undefined LeifMethod Exception 


The UndefmedLeifMethodException class indicates that the data item does not 
define the method. 


UnremovableAttributeException 


The UnremovableAttributeException class indicates an attempt to remove an 
Attribute diat was defined by the raw data item (either by reflection or a 
Translator.) Only additional Attributes added to LeifDataltems can be removed. 



h 



com.xis.leif.im 

Interface InfoModel 

All Superinterfaces: 

BeanContextChiidOwner . B eanCo ntextCh i IdOwnerPeiegator . BeanContextProxv 

Alt Known Implementing Classes: 
InFoModelSubset 



public interface InfoModel 

extends BeanCpntextC hi idQwnerDe legator 

The InfoModel interface is the interface that is used to convert raw data items into LeifDataltems. The InfoModel should 
hold each of these LeifDataltems created using weak references so that the data items can be cleaned up when they are no 
longer being used. //PENDING(RK): Any method marked with "PENDING" in the JavaDoc will likely be removed 
before LEIF is released in final form. 

Since: 

LEIF 4.0 
Version: 

SRevision: 1.20 $, SDate: 2001/08/17 00:54:54 S 
Author: 

David Almilli 



Method Summary 


void 


activatsOneOfNService (Object service ) 

//PEND[NG(RK): This method will probably be removed from InfoModel! Notify the InfoModel 
that the given service is the preferred service of its type, and that this particular object should be returned 
if its class is requested, until removed or until another object of the same type is passed to a fiiture call to 
this method. 


void 


addlnfoModelListener { InfoModel Listener listener) 

Adds a listener to this InfoModel so that the listener will be informed of changes to the InfoModel. 


void 


addOneOfNServxce (Obi act service) 

//PENDrNG(RK): This method will probably be removed from InfoModel! Add an object as a 
service to be retrieved by a call to getServiceQ (via BeanContext APIs) on any class that this object 
implements or extends. 


void 


clearSelecti.on ( ) 

Clears the selection. 


L9ieDaf_aIc«m 
(1 


dume ( ) 

Gives a list of all the LeifDataltems currently in the InfoModel. 




qetEzContext ( ) 

Gets an EZ Context that corresponds to this InfoModel so the developer can use the EZ APIs. 






getLeifDataltemi long aid) 

This will attempt to lookup a LeifDataltem from an id. 




getLeifDataItem(Obje_ct rawDatal tern) 

This will wrap a raw Java Object with a LeifDataltem wrapper so you can use it in leif as a data 

item. 




aetLeifDataltem (Obi ect rawDataltem, boolean create} 

This will wTap a raw Java Object with a LeifDataltem wrapper so you can use it in leif as a data 

item. 


LeifDatarr-eat 

n 


ae tLeifDatal terns (Obi ect f ] rawDataltems ) 

This convenience method will wrap an array of raw java Objects with LeifDataltem wrappers so 
you can use them in leif as LeifDataltems. 




getParentlnf oModeX ( ) 

Provides access to the parent InfoModel that this InfoModel delegates to. 




qetSelectedJRawDatalteias ( ) 

Gets the list of all the currently selected items for this InfoModel 




getSingl^eSelectedltein ( ) 

Get the selected raw data item, if only one. 




getViawKost ( ) 

Gets the ViewHost that this InfoMode! is associated with. 


void 


removeinf oModeiListener { Inf oModelListener listener) 

Removes a listener from this InfoModel so that the listener will no longer be informed of changes 
to the InfoModel. 


void 


removeOneOfNService (Obj_ect service) 

//PENDfNG(RK): This method will probably be removed from InfoModel! Remove an object that 
was a service to be retrieved by a call to getServiceQ (via BeanContext APIs) on any class that this 
object implements or extends. 



Methods inherited from interface cQm.xis.beans.beancontext BeanContextChildOwnerPelegator 

initialiaeBeanContextResources , releaseBeanContextReaources 



Methods inherited from interface com.xis.beans.beancontext,BeanContextChil dO wner 

9 ^-LQ:r^J>M<iBM.^S\Qp.nt&xt£h Lid 



Methods inherited from interface java.beans.beancontext.Bean(^nte\tProxy 

g.e.tB ea nCont ex t Pr oxy 



Method Detail 



getLeifDataltem 

public I^eif Dat^ltem getLaif Dataltem ( long ua.d) 

throws Datal temNotFoundException 

This will attempt to lookup a LeifDataltem from an id. If the UID is invalid or there isn't a LeifDataltem that 

already exists with that given UID, an exception will be thrown. 

Parameters: 

aid - the unique id for the raw data item. 
Returns: 




the LeifDataltem with the given UID 



getLeifDataltem 

public LeifDataltem getLeifDataltem (Ob j^t cawDataltem) 

This will wrap a raw Java Object with a LeifDataltem wrapper so you can use it in leif as a data item. 
Parameters: 

rawDatal tern - the raw data that will be wrapped. (Note: this should not already be a LeifDataltem) 
Returns: 

the wrapped data item. 



getLeifDataltem 

public Leif Dataltein getLeifDataltem (Obxec^ rawDataltem, 

boolean create) 

This will wrap a raw Java Object with a LeifDataltem wrapper so you can use it in leif as a data item. 
Parameters: 

rawDataltem - the raw data that will be wrapped. (Note: this should not already be a LeifDataltem) 
create - if false and the LeifDataltem is not already in the model, don't create one and return null 
Returns: 

the wrapped data item, or null if "create" is false and not found 



getLeifBataltems 

public LeifDataltem C 3 getLeifDatal terns (Obiect[ ] rawDataltems) 

This convenience method will wrap an array of raw java Objects with LeifDataltem wrappers so you can use them 
in leif as LeifDataltems. Note that you can get an array of raw data items often from methods like getMembersQ, 
so this is a useful method to have. 
Parameters: 

rawDatal terns - the raw data objects that wiil be wrapped. (Note: the objects should not already be 
LeifDataltems) 
Returns: 

the corresponding wrapped data item array. 



getEzContext 

public EzContext getEzContext ( ) 

Gets an E2 Context that corresponds to this InfoModel so the developer can use the EZ APIs. 
Returns: 

the ez context for this info model 



getSingleSelectedltem 

public O biect getSingleSelectedltem { ) 



mo 



Get the selected raw data item, if only one. Else return null. 
Returns: 

the selected item if there is only one. 



getParentlnfoModel 

public InioMn-iei getParentInf oModel ( ) 

Provides access to the parent InfoModel that this InfoModel delegates to. If there is no parent model then this will 

return null. 

Returns: 

the parent InfoModel 



clearSelection 

public void clearSelection ( ) 
Clears the selection. 



getSelectedRawDataltems 

public Object ( ] getSelectedRawDataltems { ) 

Gets the list of all the currently selected items for this InfoModel 
Returns: 

all of the selected data items (as raw data items) 



activateOneOfNService 

public void activateOneOfNService (Object service) 

//PENDrNG(RK): This method will probably be removed from InfoModel! Notify the InfoModel that the given 
service is the preferred service of its type, and that this particular object should be returned if its class is requested, 
until removed or until another object of the same type is passed to a future call to this method. 
Parameters: 

service - the object to become the preferred service 



addOneOfNService 

public void addOneOfNServ3.ce { Object service) 

//PENDrNG(RK): This method will probably be removed from InfoModel! Add an object as a service to be 
retrieved by a call to getServiceQ (via BeanContext APIs) on any class that this object implements or extends. 
Parameters: 

service - the object to be returned when requested 




removeOneOfNService 

public void removeOneOfNService {pbj eg t service) 

//P£ND[NG{RK): This method wil! probably be removed from InfoModel! Remove an object that was a service to 
be retrieved by a call to getServiceQ (via BeanContext APIs) on any class that this object implements or extends. 
Parameters: 

service - the object to be removed from service 



getViewHost 

public ViewHost gstViewHoat { ) 

Gets the ViewHost that this InfoModel is associated with. If this InfoModel is not associated with a ViewHost then 

this will return null. 

Returns: 

the view host that is maintaining this InfoModel. 



addlnfoModelListener 

public void addlnfoModelListener { InfoModelListener listener) 

Adds a listener to this InfoModel so that the listener will be informed of changes to the InfoModel, 
Parameters: 

listener - the listener to add 



removelnfoModelListener 

public void reiaoveinf oModelListener t Inf oModelListener listener) 

Removes a listener from this InfoModel so that the listener will no longer be infb.rmed of changes to the 

InfoModel. 

Parameters: 

listener ♦ the listener to remove 



dump 

public LeifPataltem n dump { ) 

Gives a list of all the LeifDataltems currently in the InfoModel. It is highly recommended to use this method only 
if you absolutely have no other way of accompilshing the task you need to do. Please keep in mind that if you hold 
onto the LeifDataltems contained in the array returned or if you hold onto the array itself, the items will not be 
removed from InfoModel until you release them. If you wish to hold onto them, you should wrap them in 

WeakRef erence objects. 

Note: When you use the dumpQ method in combination with the addlnfoModelListener so that you can keep track 
of the same set of LeifDataltems as the InfoModel, you can synchronize on the InfoModel to get the dump and 
then add a listener to receive events of future changes. 



Example: 

synchronized (infoModel) ( 

LeifDataIteni[ ] dataltems « inf oModel . dump ( ) ; 
infoModel . addinf oModelListener (this ) ; 
for (int i»0; i < dataltems . length; i++) { 
process Item {dataltems (i] ) ; 

) 

} 



Returns: 

the list of Lei fData Items currently in the InfoModel, 
See Also: 

WeakRef erence 



Package com.xis.leif.event 

This package contains classes for handling events in XIS. 



See: 

Description 



Interface Summary 


InfoModelListen er 


The inf oModelListener is used to monitor changes to an InfoModel. 


LeifDataltemListener 


This class is used for hstening to LeifDataltems for various events. 



Class Summary 


Attn D u tev> n an £eci vent 


An " AttributeChanged" event gets delivered whenever a data item 
changes an attribute value. 


ContHinerAdded£vent 


A "ContainerAdded" event gets delivered whenever a data item is 
contained as a member in a new object. 


uii i«iiici rvciiiu V cuxLi v cu i 


A "ContainerRemoved" event gets delivered whenever a data item has 
been removed as a member from a containing object. 


DataltemReplacedEvent 


The DataltemReplacedEvent class is used to indicate member changes 
of a containing data item. 


InfoModelEvent 


The InfoModelEvent gets delivered whenever a LeifDataltem is created 
by the InfoModel, or when a LeifDataltem has been "lost" by the 
InfoModel. 


InfoModelEventSupport 


The Inf oModeiEventSupport support class provides basic support for 
managing listeners on an InfoModel. 


LeifD atal temAdapter 


The Leif DataitemAdapter class provides support for setting up a 
LeifDataltemListener on a data item. 


LeifEventSupport 


This is a utiUty class for XIS developers to use when they want to fure 
event changes. 


MemberAddedEvent 


The MemberAddedEvent class indicates that members were added to 

this data item. 


MemberEvent 


The MemberEvent class is used to indicate members changes of a 
containing data item. 


MemberRemovedEvent 


The MemberRemovedEvent class indicates that the members are being 
removed from the containing data item. 


ReferenceAddedEvent 


The ReferenceAddedEvent class indicates that LeifReferences were 
added to the LeifDataltem. 


ReferenceEvent 


The ReferenceEvent class indicates changes to the LeifReferences of 
the data item. 



ReferenceRemovedEvent 


The ReferenceRemovedEvent class indicates that LeifReferences were 
removed from the LeifDataltem. 




ReferrerAddedEvent 


The ReferrerAddedEvent class mdicates that a Referrer was added to 
the data item. 


ReferrerRemovedEvent 


The ReferrerRemovedEvent class indicates that a Referrer was 
removed from the data item. 





Package com.xis.leif.event Description 

This package contains classes for handling events in XIS. 
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TestHarnessjava 



/* XIS Tutorial standalone sequence example 5 XIS interfacing. 7 

import javax.swing JFrame; 

import ]ava.awt.event.WinclowAdapter; 

import java.awt.event.WindowEvent; 

/*{7 

import ]ava.awt.GridLayout: 

import java.awt.Toolkit; 

import java.awt.Dimension; 

import java.awt.event.ComponentAdapter; 
, import java.awt.event.ComponentEvent; 
p import javax.swing JSplitPane; 
^ import javax.swing JComponent; 

y m 

-3 import jclass.chart JCChart; 

i4 import com.xis.Ieif.im.BaselnfoModel; 

O import com.xis.plot.PlotlnfoBean; 

import com.xis.plotchartviews.LeifChartView; 

import com.xis.table.TablelnfoBean; 
; f import com.xis.tree.TreelnfoBean; 
pi ^*}*' 

fi public class TestHarness { 

public static void main(StringQ args) { 

// the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModel.setStartingPluglnManager(false); 

/*{*/ 

HelloWorld hellol = new HelIoWorld("First HelloWorld object."); 
HelloWorld hello2 = new HelloWorldfSecond HelloWorld object."); 
HelloWorld helloS = new HelloWorld('Third HelloWorld object."); 
HelloWorld hello4 = new HelloWorld("Fourth HelloWorld object."); 
HelloWorld helloS = new HelloWorldfFifth HelloWorld object."); 



Figure 37B 



Continuation of TestHarness.java 



ObjectQ helloArray = new ObjectO { hellol, hello2, helloS, helio4, 
helloS }; 

// create table and plot infobeans to display HelloWorld objects 
TablelnfoBean table = new TablelnfoBean(); 

PlotlnfoBean plot = new PlotlnfoBean(); 
plot.setChartType(JCChart,BAR); 

//the alternatives are SCATTER^PLOT. PLOT, AREA, PIE, CANDLE, 
// and STACKING_BAR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 
// see step 3 for further comments. 
plot.setYAxisAttribute( 

"com.xis.domains.movement.MovementDomain.speed"); 
plot.setDynamicAdjustment(true); // so axes track value magnitude 
plot.setBarChartAdjusting(true); // needed in some cases for bar chart 



// a top-level frame as before to hold both plot and table side-by-side 
JFrame tablePlotFrame = new JFrame("HelloWorld(s) Table/Plot"); 
// use a repaired JSplitPane (see below) to manage the two beans 
SaneJSplitPane splitpane = new SaneJSpIitPane(table,plot, 
new Dimension(table.getPreferredSize().width + 
plot.getPreferredSize().width, 
Math.min(table,getPreferredSize().height, 
piot.getPreferredSize().width)), 

0.50); 

tablePIotFrame.getContentPane().add(splitpane); 
tablePlotFrame. pack(); 
tablePlotFrame.setVisible(tnje); 

// a tree infobean to display our HelloWorld objects 
TreelnfoBean tree = new TreelnfoBean("HelloWorld(s) Tree"); 
tree.addRawDataltems(helloArray); 

// a top-level frame to hold our tree infobean 

JFrame treeFrame = new JFrame("HelloWorld(s) Tree"); 
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Continuation of TestHarness.java 

// avoid placing the windows on top of one another if we can 
int cutoffHeight = 424; 

if (Toolkit.getDefaultToolkit().getScreenSize().getHeight() > 
cutoffHeight + 200) { 

treeFrame.setLocation(348,cutoffHeight+7); 

} 

■V 

// add a listener for window closing 
treeFrame.addWindowListener( 
new WindowAdapterO { 

public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 

// stick the tree infobean in the frame and display it 

treeFrame.getContentPane().add(tree); 

treePrame.packO; 

treeFrame.setVisible(true); 

} // main 



Jie-k 

* This class overrides the default JSplitPane to provide a reasonable 

* resize behavior: maintain the left and right panels in the same 

* proportions. 
*/ 

public stati,c final class SaneJSplitPane extends JSplitPane { 

private int lastWidth; 
private double lastDividerProp; 

public SaneJSplitPane(JComponent leftComponent, 
JComponent rightComponent. 
Dimension dims, double startProportion) { 



Figure 37D 



Continuation of TestHarness.java 

super(JSplitPane.HORIZONTAL_SPLIT, 

leftComponent, rightComponent); 
setSize(dims); 

// Since the JSplitPane doesn't set the lastDividerLocation 

// variable, nor does it provide any other easier way to maintain 

// the split proportion on resize, we must track the divider 

// location ourseif. 

iastWidth = dims.width; 

lastDividerProp = startProportion; 

setDividerLocation{startProportion); 

// this listens for resize events on the splitpane and makes sure 
// we keep same split proportions 
addComponentListener(new ComponentAdapter() { 

public void componentResized(ComponentEvent event) { 
setDividerLocation(lastDividerProp); 
IastWidth = (int)eventgetComponent(). 
getSize().getWidth(); 

}}); 

// only way to know if divider moved by user is to listen for 
// resize events on the components; this isn't foolproof (since 
// resizes can come from other sources) but it works well enough 
leftComponent.addComponentListener(new ComponentAdapter() { 
public void componentResized(ComponentEvent event) { 
// we add in getDividerSize() / 4 to compensate for a 
// bug in JSplitPane which doesn't take account of the 
// divider width in location-proportion conversions 
lastDividerProp = {double)(getDividerLocation() + 
(getDividerSizeO / 4)) / IastWidth; 

}}); 
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First HelioWorld object 



Third HelioWorld object 



I rourth HelloWorid object 



HelloWorldfs) Tree 



^ E3 First HelioWorld object. 
®"-E3 Second HelioWorld object. 
®" C3 Third HelioWorld object 
^ II3 Fourth HelioWorld object. 
®- £3 Filth HelioWorld object. 
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com.xis.leif.iin 

Interface AttributeAlias 



public interface AttributeAlias 



The AttributeAlias indicates an alias jfrom L.n Attributes to a single Attribute, together with a 
precision level; the higher the precision, the better the alias. The alias allows a caller to query for one 
of the 1 ..n "from" attributes and get the value stored by the data item under the "to" attribute, possibly 
mediated by some conversion, such as a units transfomiation. 

If the converted or calcuated value cannot be determined, then the Attribute#getvalue ( ) method 
should throw an UnconvertibleAliasException . This Exception is a subclass of the 
fe,g,Undefi nedLeifAttributeException which is typically thrown by normal Attributes in this case, 
provide a descriptive message indicating the source of the incompatibility. 

yThe utility of attribute aliases may be seen by considering the following example: 

lyThe user has performed a query from an external data source and retrieved a set of Airfields, indexed 
i :;jby an ICAO identifier. The user now wants to get the hst of Aircraft at one of the airfields. There is a 
Ofllocal aircraft database with a foreign key field for Airfields, but that key is a WAC identifier, not 



oAssumption: The application was NOT written ahead of time to know about these two databases or 
rliitheir ID types. Instead, what you have is an XIS "Leif Dataltem" for the Airfield, and you have an 
i ;XIS InfoBean for the Aircraft query form. 



|4What you want to do is to copy (or "drop") the Airfield data item into the "WAC" field m the query 
form. In domg this, the Forai will ask the data item for its "WAC" attribute (because this is all it 
knows about). It uses the "getWAC ( ) " method from some domain (say, the Airf ieldDomain). 

The way this could work is that there would have to be an AttributeAlias defined to convert ICAO 
to WAC - or, more specifically, AviationDomain. ICAO to Airf ieldDomain. WAC. The 
AttributeAlias returns an Attribute object that knows how to transform ICAOs to WACs (e.g., 
by accessing a conversion table). The Attribute, in turn, has a getvalue ( ) method to execute that 
transfonnation and return the WAC. 



This process would be entirely transparent to the user, or even the caller, who would just see a result 
returned from the getWAC ( ) method. In cases where the conversion was not possible, the 
UnconvertibleAlia sException would be thrown, possibly providing informative information to 
the caller or user. 



Finally, note that due to the way the mechanism is set up (using resources and a PluggableService) . 
this AttributeAlias can be installed as a separate module without requiring any re-coding or re- 
compilation of the existing application. 



Method Summary 


AttributeDescriptor 
C] 


getAliasedFrom ( ) 

This indicates which AttributeDescriptors (which in turns means which 
Attributes) are required for the alias. 


AttributeDescriDtor 


getAliasedTo { ) 

This indicates the AttributeDescriptor that this AttributeAlias is for. 


Attribute 


getAt tribute ( ) 

Get the Attribute object that is the alias Attribute. 


int 


getPrecisionPrioritY ( ) 

This indicates the precision of the AttributeAlias. 



Method Detail 



getPrecisionPriority 

public int getPrecisionPriority { ) 

This indicates the precision of the AttributeAlias. The higher the number the better the alias. 
This number is used to determine which AttributeAlias to use when there are more than one 
alias for a given Attribute. 
Returns: 

the precision of the alias. 



getAliasedFrom 

public AttributeDescrip tor f 1 getAliasedFrom ( ) 

This indicates which AttributeDescriptors (which in turns means which Attributes) are required 

for the alias. 

Returns: 

the list of descriptors required for this alias. 



getAliasedTo 

public AttributeDescrip tor getAliasedTo ( ) 

This indicates the AttributeDescriptor that this AttributeAlias is for. 
Returns: 

the descriptor that this alias is for. 



getAttribute 



public Attribute getAttribute ( ) 

Get the Attribute object that is the alias Attribute. This attribute is responsible for performing 
the translation from the aliased from Attributes. The AttributeDescriptor of the Attribute 
MUST be the same AttributeDescriptor returned by getAliasedTo. 
Returns: 

the attribute that will do the translation. 
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